home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / boot tools / bootselector1.31 / doc / bootselector_engl.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  17KB  |  340 lines
  1. @database BootSelector.GUIDE
  2. @$VER: BootSelector.GUIDE 1.31 (22.11.95)
  3. @(c) "G
  4. lleSoft 1995"
  5. @author "Michael Gollmick"
  6. @node "Main" "BootSelector V1.31"
  7.   --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  --
  8.    ________
  9.   \\   ___  \\  
  10. _     ____  ____           _______      _______
  11.    \\  \\  \\__\\   \\  \\   / _ / / _ /______    / _____/     /_  _  /___
  12.     \\  \\     ___ \\ \\\\ /  //_/  //_   __/   / /_________ //  //_//  /__
  13.      \\  \\ ___\\  \\ \\  X   / _\\  / _\\  _)_  /____  /  _  X   /_/_   ___/
  14.       \\  \\\\___\\  \\/  /  /  // /  // /   \\ _   / /  (_)  ) ___//  /
  15.        \\  \\___\\\\____/  /   / /   /_______\\/__/ / \\     / /   /  /
  16.     \\________\\/_______/_____/      /______/   \\___/ /   /__/
  17.                             /__/   
  18.     - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- -
  19.                   presents
  20.                   BootSelector 1.31
  21.                   =================
  22.  1995 by Michael Gollmick
  23.     I   @{"
  24. Distribution    
  25. " link "Distribution" 0} This is MAILWARE
  26.     II  @{"
  27. Warranty
  28. " link "Warranty" 0} No warranty!
  29.     III @{"
  30. Requirements   
  31. " link "Requirements" 0} 68060, 32MB RAM, Gfx-Board? No!
  32.     IV  @{"
  33. Introduction
  34. " link "Introduction" 0} Something about the program
  35.     V   @{"
  36. Usage and
  37. Installation    
  38. " link "Usage" 0} How to use a program
  39.     VI  @{"
  40. " link "BUGS" 0} No BUGS in this version, sorry
  41.     VII @{"
  42. The Future 
  43. " link "Future" 0} What future developing will bring
  44.     VIII@{"
  45. Credits
  46. " link "Credits" 0} People who helped me
  47.     IX  @{"
  48. History
  49. " link "History" 0} The most boring part...
  50.     X   @{"
  51. Support
  52. " link "Support" 0} Hotline for free...
  53. @endnode
  54. @node "Distribution" "Distribution"
  55. Distribution
  56. ------------
  57. BootSelector is freely distributable Software. The archive must not be modified
  58. and  must  be  spread as a whole. BBSes may add their sign to the archive. This
  59. program is not Public Domain. It is FREEWARE. Thats why I haven't included  the
  60. sources. This program is also MAILWARE. That means, I expect a mail or a letter
  61. from everyone, who is using it. This mail should contain some information about
  62. the  particular  machine being used and the user. Your information will help me
  63. TO remove BUGs quicker.
  64. Personal information is kept confidential and is only for me.
  65. This archive may be included in every PD-Library, BUT under the  observance  of
  66. the  conditions  named,  and  also  of  mailing or writing to me as the author.
  67. Excluded   from   these   conditions   are   only   the   Aminet-    and    the
  68. Fred-Fish-Collections.  If  you  mail  me  (and  this  is the proper meaning of
  69. MAILWARE), please use the following sheet:
  70. -------------------------------------------------------------------------------
  71. Name, Firstname:
  72. E-Mail         :
  73. Country, City  :
  74. Computer       :
  75. Kickstart      :
  76. Processor      :
  77. Memory         :
  78. Comment        :
  79. -------------------------------------------------------------------------------
  80. @{"Main Menu" link "Main" 0}  @{"Warranty" link "Warranty" 0}
  81. @endnode
  82. @node "Warranty" "Warranty"
  83. Warranty
  84. --------
  85. There is no warranty implied with this software.  Please read the following:
  86. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  87. LAW.  EXCEPT  WHEN  OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
  88. OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT  WARRANTY  OF  ANY  KIND,
  89. EITHER  EXPRESSED  OR  IMPLIED,  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  90. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR  A  PARTICULAR  PURPOSE.  THE
  91. ENTIRE  RISK  AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  92. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST  OF  ALL  NECESSARY
  93. SERVICING, REPAIR OR CORRECTION.
  94. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING  WILL
  95. ANY  COPYRIGHT  HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
  96. AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,  INCLUDING  ANY  GENERAL,
  97. SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL  DAMAGES  ARISING OUT OF THE USE OR
  98. INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA  OR
  99. DATA  BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
  100. OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER  PROGRAMS),  EVEN  IF
  101. SUCH  HOLDER  OR  OTHER  PARTY  HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  102. DAMAGES.
  103. @{"Main Menu" link "Main" 0} @{"Distribution" link "Distribution" 0}
  104. @endnode
  105. @node "Requirements" "Requirements"
  106. Requirements
  107. ------------
  108. I don't know what your local PC-Dealer is recommending (but  most  likely  he's
  109. trying  to  sell  only  overbeared, wrong calculating 5umms or a "really great,
  110. favourable,  powerful"  80268  and  conceals,  that  PC's   where   technically
  111. overhauled already in 1989)
  112. We against recommend FOR this really useful program:
  113.  - Amiga 500, 500+, 600, 1000, 1200, 2000, 3000, 4000; DraCo
  114.  - Kickstart 2.0 or higher
  115.  - Harddisk (recommended!)
  116.     because selecting the `Startup-Sequence` in Floppy-Disks-Only-Mode is a
  117.     little bit senseless, nevertheless the program will work.
  118.  - a mouse of course
  119.  - `Execute`-command
  120. @{"Main Menu" link "Main" 0}  @{"Introduction" link "Introduction" 0}  @{"BUGS" link "BUGS" 0}
  121. @endnode
  122. @node "Introduction" "Introduction"
  123. Introduction
  124. ------------
  125. Are you familiar with the problem? You invested Money in a better Monitor  (VGA
  126. or  Multi-sync)  and the mode you use is not the 15 Khz default Screenmode? But
  127. when booting, your Amiga is in it's in native Screenmode of 15kHz?  Imaginative
  128. as  we Amiga-purists are, we write some '>NIL:'s to the Startup-Sequence and we
  129. are no longer in the 15kHz-Screen. On  Relais  Monitors  switching  into  other
  130. frequencies  occurs with a loud click when IPrefs is started. The screen is now
  131. opened in its higher frequency and your machine is ready  to  work.  Since  the
  132. Amiga  is  an  open ended machine with unlimited methods of configuration, many
  133. users configure their machines using different script files (as I sometimes  do
  134. myself)  and  execute  these  script  files using a program such as BootManager
  135. (from Daniel Bachmann). And are subject again  to  the  lousy  old  Problem  of
  136. clicking relais. All this 'choosing-programs' has had the same problem: We open
  137. a 15kHz-Screen, choose our script, let click the relais and switch the mode  to
  138. Super-Hires-256 NonInterlace.
  139. IF not FOR the lousey 15 Khz DEFAULT screen I would be using BootManager today.
  140. But  of  course  the BootManager is used by me even today, if there wouldn't be
  141. this lousy 15-kHz-Screen! Now ask your physician or druggist and he wouln't  be
  142. able  to  help you, he is already happy, if he is able to run his cash-software
  143. on his PC and in no case he can spent any time in a 'lousy' Amiga (I also think
  144. 99.9%  of  all  physicians  and  druggists  have  no  idea of the Amiga). So we
  145. continue searching some solution.
  146. After spending countless hours searching for a program  to  solve  the  15  Khz
  147. dilemma,  I decided to come up with a solution of my own, knowing others in the
  148. Amiga community would benefit from my efforts.
  149. After numerous attempts, I had a version which was able to execute a script  if
  150. a  mousebutton was pressed at start up. I decided to expand this feature for my
  151. brand new 3 Button-Mouse. So it was finally possible  to  execute  6  different
  152. scripts  with a 3-Button-Mouse or 3 different scripts with a 2-Button-Mouse. On
  153. my machine, BootSelector is now running with only 3 Startup-Sequences  (because
  154. I don't need more).
  155. It looks as follows:
  156. IF you don't press any  mousebutton  at  startup,  the  machine  will  boot  in
  157. ordinary  fashion with no opened screen, AND the standard-Startup-Sequence will
  158. be loaded.
  159. IF you press the middle mousebutton, BootManager will be loaded.
  160. IF you press the left mousebutton at startup, my favourite game will be loaded.
  161. I havn't put a Startup-Sequence onto the other mousebuttons,  because  I  don't
  162. need  more  at  the moment. But the potential is there. You can use the RMB and
  163. combinations of the mousebuttons, for a total of six different  scripts,  since
  164. LMB+RMB  and  LMB+RMB+MMB  are used by systems early startup (Startup-Menu). In
  165. the future there will be a solution for using these combinations too.
  166. @{"Main Menu" link "Main" 0}  @{"Requirements" link "Requirements" 0}  @{"Installation" link "Usage" 0}
  167. @endnode
  168. @node "Usage" "Usage & Installation"
  169. The useage + installation
  170. -------------------------
  171. The best way to install this package is to use the  included  Installer-Script.
  172. Please  confirm  (through  the  CBM  version  command)  that  you are using the
  173. Commodore Installer Version 1.24 or higher, since there will  be  some  obvious
  174. malfunctions if you use a lower version.
  175. When the Installation is  complete,  you  should  configure  your  existing  or
  176. alternative  scripts  thru  BootSelector.  For  doing  this,  you should do the
  177. following:
  178. - open the Startup-Sequence from S: for editing.
  179. - add a  keyword  after the command BootSelector in  the  first  execution-line
  180.   (e.g.  LMB),  than  a  '=' followed by the name of the alternative script. It
  181.   could look as folows:
  182.   BootSelector LMB=Galaga.STARTUP
  183. - additionally  there  should  be  a  path  FOR  the  alternate  scripts  since
  184.   BootSelector  searches  the  S:  path by default. But if you are working with
  185.   many Startup-Sequences  it  is  recommended  you  put  them  into  their  own
  186.   directory  (as  done by the Installer; e.g. S:Startup's). This information is
  187.   done by the keyword DIR or SCRIPTDIR. It looks as follows:
  188.     BootSelector SCRIPDIR=S:Startup's/
  189.   It is imperative  the  ending  '/'  (backslash)  or  ':'  is  present,  since
  190.   BootSelector  does  not  automatically append it and will fail if this is not
  191.   included.
  192. - At the end the line should look nearly this:
  193.     BootSelector LMB=Alternate.Startup MMB=Galaga.Startup DIR=S:Startup's/
  194. - The single Keywords(ToolTypes) may be shown by the command  'BootSelector  ?'
  195.   Here the descriptions:
  196.    REGULAR=REG   IF you press no mousebutton
  197.    LMB           IF you press left mousebutton
  198.    MMB           IF you press middle mousebutton
  199.    RMB           IF you press right mousebutton
  200.    LMM           IF you press left AND middle mousebutton
  201.    RMM           IF you press right AND middle mousebutton
  202.    SCRPTDIR=DIR  Path FOR ALL the Scripts
  203. The Installer-Script does copy some alternative scripts to  S:Startup's,  which
  204. have  the  same  names  as the defaults in BootSelector. So you can also rename
  205. your alternative scripts to these names or edit the include scripts. If you  do
  206. this, there is no need to edit the keywords after the command BootSelector.
  207. With the command 'version Startup-SequenceXXX' you can learn  which  script  is
  208. for  which  mousebutton, where XXX stands for the roman numerals after the word
  209. Startup-Sequence.
  210. @{"Main Menu" link "Main" 0}  @{"Requirements" link "Requirements" 0}
  211. @endnode
  212. @node "BUGS" "BUGS"
  213. This program has been tested on my machine most extensively (in  the  long  and
  214. wee hours of the night, nights where I was more nearly to a coffein shock as to
  215. a regular night sleep. In times, where my consume of  coffee  gots  dimensions,
  216. which  where  not payable for me and hearings at University where not main goal
  217. of my life).
  218. What I want to say with it: If you find a BUG in this program, Im really sour!
  219. But Seriously: As I published this Version,  I  was  at  the  meaning  to  have
  220. reached  a  status  of BUGlessness, which makes it possible to do a publishing.
  221. (But, by the way, I was near a Coma and  a  physical  state  was  near  a  full
  222. seediness and prevented further work on it).
  223. About information of mailfunctions I wouldn't be happy, but if they reach me, I
  224. will stop studying, plunder the next hypermarket (need some coffee), and code a
  225. BUGfree version.
  226. Your Bugreports reach me via e-mail:
  227.            wir94dgk@Rzaix340.rz.uni-leipzig.de
  228. or via postal way:
  229.            Michael Gollmick
  230.            L
  231. bauer Stra
  232.            04347 Leipzig
  233.            Germany
  234. Testconfigurations:
  235.  -AMIGA 1200, 2MB CHIP, 8MB FAST, Blizzard 1220 Turboboard, Kickstart 3.0
  236.  -AMIGA 1200, 2MB CHIP, 4MB FAST, Blizzard 1230II Turbboboard, Kickstart 3.0
  237.  -AMIGA 500+, 2MB CHIP, 2MB 16-BitFAST, Roktek HD-Controller, Kickstart 3.1
  238.  -AMIGA 500, 1MB CHIP, 1.5MB 16-BitFast, 4MB 32-BitFast, Neuroth 68020/882,
  239.   FSE-SCSI-Controller, Kickstart 3.1
  240.  -AMIGA 500, 512kB Chip, 512kB Fast, Kickstart 2.04
  241. @{"Main Menu" link "Main" 0}
  242. @endnode
  243. @node "Future" "Future"
  244. The future
  245. ----------
  246. What I have planed for further version, what might be included
  247.   - a GUI in higher resolutions (I've tried hard, but I couln't realize
  248.     until now)
  249. I`m very thankful for suggestions  concerning  this  program  as  well  as  for
  250. further  projects.  Your  name  will be included in my credit list and you will
  251. recieve a free update (seems to be a little bit strange because this program is
  252. FREEWARE, doesn`t it?).
  253. @{"Main Menu" link "Main" 0}
  254. @endnode
  255. @node "Credits" "Credits"
  256. Credits
  257. -------
  258. I`m very thankful to:
  259.         Michael Reichenbach Oliver Steinh
  260. user and others
  261.          - for agonizing beta-testing
  262.          - as well as for ideas which are implemented in this
  263.            project or may be included in later versions
  264.         Pascal Behrend
  265.          - for reworking the german manual
  266.          - for translating the manual into English (Have you ever read
  267.            my translation? No? - Seems to be the best!)
  268.         Ville Ranki
  269.          - for the Finnish Guide
  270.         Ron Shaw
  271.          - for spellchecking the english documentation
  272.         Commodore
  273.          - for developing the best computer (todate) with a
  274.            tremedous Operating System.
  275.         ...and all who mailed me
  276. @{"Main Menu" link "Main" 0}
  277. @endnode
  278. @node "History" "History"
  279. History
  280. -------
  281. The story so far...
  282. ... Version 1.01 - INITIAL AMINET RELEASE
  283.     07.08.95     - 
  284.                  - removed the ReadTooltype()-BUG from V1.00
  285.          - includet the Version-String for VERSION
  286.          - new Errorhandlingroutine
  287.          - Errorhandlingroutine has been improoved
  288.          - code optimized again (gained 1234 bytes)
  289.          - bug fixed: machine crashed when a wrong directory was set
  290.                  - finished Documentation for the Release
  291. -----------------> Had a very BAD hardcrash on my HD, so I had to stop the
  292.            developing for a while
  293.                  > restarted the developing on 19.08.1995 with an old 80MB HD
  294. ... Version 1.10 - OFFICIAL AMINET RELEASE
  295.     30.08.95     - Code has been optimized again (gained 36 Bytes)
  296.                  - now up to tree times faster due to the optimization
  297.                  - REGULAR Tooltype may be edited short now
  298.                  - Errorhandler has been overworked again
  299.                  - needs less memory for its work
  300. -----------------> Developing stopped for some weeks due to some practical
  301.                    work and a fu..ing accident
  302.                  > development restarted on 3.10.95
  303. ... Version 1.24 - OFFICIAL AMINET RELEASE
  304.     23.10.95     - addet the combination of LMB & MMB
  305.                  - REGULAR is no longer a required keyword and has a default
  306.                    value now
  307.                  - created an Installer-Script (in German an English)
  308.                  - addet the Finnish Guide (thanks to Ville Ranki)
  309.                  - addet the INFO keyword
  310.                  - RMB is now detectable and includet
  311.                  - addet a small filecheck
  312.                  - optimized the code again due to new functions
  313.                  - a red screen will be opened, if required Startup-Sequence
  314.                    can't be found
  315.                  - overworked the english DOC (thanks to Ron Shaw)
  316. ... Version 1.30 - NOT OFFICIALLY RELEASED
  317.     03.11.95     - removed the OpenFile() bug finally (didn't succeed before)
  318.                  - the red screen opens now in 320x200pix (for NTSC-users)
  319.                  - some code optimisation
  320.                  - addet an automatical path-detection
  321. ... Version 1.31 - OFFICIAL AMINET RELEASE
  322.          - removed two useles tooltypes, since using them is im-
  323.            possible, cause of the system. If you have read them by
  324.            typing bootselector ?, you may have wondered
  325.          - updated documentation amd Install script
  326. @{"Main Menu" link "Main" 0}
  327. @endnode
  328. @node "Support" "Support"
  329. Hope you can use this program. I would be happy about  any  reactions  to  this
  330. program.  If  you  use  it  or  if you have problems/questions, so feel free to
  331. contact me under:
  332.            wir94dgk@rzaix340.rz.uni-leipzig.de
  333. I will try to answer your questions within seven days if I can.  (In  the  last
  334. two  month  there where some problems getting acces to the net, so it took much
  335. longer than seven days. I want to excuse me for this in this way.)
  336. Michael Gollmick
  337. in November 1995
  338. @{"Main Menu" link "Main" 0}
  339. @endnode
  340.